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INTRODUCTION 

This is the Alpha Micro Software Notes , a publication designed to give 
techniqal software information to our OEM/dealer network. Please address 
all inquiries or suggestions concerning this newsletter to: 

Editor, Alpha Micro Software Notes 
Advanced Products Development Group 
P.0. Box 18347 
Irvine, CA 92713 

NOTE: Because no software patches were issued by the Advanced products 
Development Group during the month of July, we did not produce an; August 
issue of the Software Notes. 


SOFTWARE HINTS 


AlphaBASIC File Locking Programming Hint 


One of our dealers contributed the following programming hint, which is most 
useful for those of you whose AlphaBASIC programs use file locking: 

If your programs use FLOCK or XLOCK to lock file records, you probably 
know that these programs use up system queue blocks. Occasionally 
other programs can snap up all available queue blocks : (e.'g., 
PRINT/WAIT) just as XLOCK or FLOCK are about to process your program's 
request— this can cause the system to crash because no more queue 
blocks are available. If this has happened to you, you may want to 
check to make sure that an arbitrary number of queue blocks are free 
before executing your XLOCK or FLOCK call. To do so, include a test 
before calling XLOCK or FLOCK that checks memory location 144. 
(Location 144 contains the number of free queue blocks.) For example: 

IF WdRD(144) >= ENOUGH THEN GOTO LOCK'FILE ' ‘ j 

■ PRl’tJT "Sorry. Not enough queue blocks available. Try again later." 

GOTO END'TRX 
LOCK' FILE: _ 

! f 

Just a note of caution: We cannot guarantee that location 144 will always 
contain the number of free queue blocks. Check the SYS.MAC file each AMOS 
Release to see if the location of QFREE has changed. (Currently, jf you 
assemble that file, you will see that the octal location of QfREE is 220 
(144,;decimal).) 



SOFTWARE NOTES - SEPTEMBER 1981 


Page 2 


SORT Minimum Memory and Disk Requirements 

Several r^aderis have asked us what the minimum memory and disk requirements 
are of SORT.pRG. The minimum memory requirement is IK of free memory <that 
is, IK of ; memqry in addition to the amount of memory required to load SORT), 
and the minimum disk requirement is twice the size of the file. (If the 
file is random, that disk area must be contiguous.) 


LOOKUP Monitor Call 

f 

The discussion of the LOOKUP monitor call in the AMOS Monitor;Cal Is 
Manual, (DWM-00100-43) does not discuss the code returned by LOOKUP. 
LOOKUP returns any of the standard error codes (e.g., protection violation, 
file not found, etc.). However, note that the byte returned is negative . 
Before comparing it to the standard error codes, remember to negate the 
number first. 


SOFTWARE CHANGE NOTICES 


All of the patches in this month's issue are to the monitor, SYSTEM.MON. 
Notice that two of the patches given below require that you use MONGEN to 
generated new version of the monitor after those patches are mac|e. You 
MUST use . MONGEN after these patches are made— if you do not, your system 
will not bbot with the patched monitor. 

As with alt patches to the monitor, we do not give "before and after" hash 
totals— this is because the hash total of the monitor differs depending on 
what disk ^driver has been MONGENed into that monitor. Since you do not have 
a hash totjjal to look at to ensure that the patch was made correctly,, we 
suggest that you perform monitor patches by making a copy of the monitor, 
making the 1 pdtch to the copy, and then using MONTST to test the copy. 
(Remember 1 that the System Disk must be installed on the first fixed surface 
of the System Drive in order to use MONTST. Also, on non-MPC systems, the 
job using MONTST must be operating in the first memory partition on the 
system.) ‘We step through this recommended procedure in each of the patches 
below. s 
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SYSTEM.MON (Version 4.5) 

If your 1, monitor is version 4.5, make the following two patches in thfe order 
given: 

Patch #1 (4.5) - WAKE and ASSIGN Monitor Calls 

This patch Corrects problems in the AMOS 4.5 monitor with the ASSIGN and 
WAKE m'onjtor calls for bank switched systems. The symptoms of these 
problems are that the ASSIGN call does not exclude multiple job$ from a 
non-sharable device; and, the WAKE call causes the SLEEP monitor ica'll to 
return an| improper return code when a job is awakened from another bank. 

Note that' you MUST use MONGEN to generate a new monitor after mailing this 
patch; this is because the patch extends into a portion of the'*current 
driver ar,ea', and you must use MONGEN to re-embed the driver. * 

, ) 

NOTE: The underlined question marks below indicate that the contentsof that 
memory location may be anything. 
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J-06 SYS:(ret) 

Loggedlinto SYS: 

^COP;Y' NEWSYS=SYSTEM.MON (ret) 
SYSTEMi;MON to NEWSYS.MON 


Total ; of 1 file transferred 


.DDT NEWS YS. MON (ret) 

PROGRAM BASE IS XXXXXX 
PROGRAM SIZE IS 34530 

210/ SUB -(R1),(R4)+ 

24224GHD 

20324/ 

i 1 

SUB -(R1),(R4)+ 

24224GHD 

12676/ 

: i 

CMP 6(SP),#12 

CMP 4CSP),#12(EH) 

12620/ 

CALL 23160 

CALL PC,24124(MD 

241247 

999999 

MOV R2,-(SP) * 

241267 

999999 

CALL PC,23160* 

24132/ 

?????? 

0 * 

24134/ 

999999 

MOV (SP)+,R2* 

241367 

---f— 

999999 

RTN PC (EH) 

3616/! 

BR 3622 

BR 3630 (EH) 

3622/ 

MOV 3R4,R3 

CMP R4,#162 * 

3626/ 

CMP 6(R3),R0 

BEQ 3664* 

3630/ 

BPT 

MOV 3R4,R3* 

3632/ 

BNE 3620 

CMP 2(R3>,#3552* 

3640/ 

MOV 130(R0),R3 

BNE 3620* 

3642/ 

SVCA 30 

CMP 6(R3),R0* 

3646/ 

HALT 

BNE 3620* 

3650/ 

RSTS 

SVCA 33* 

3652/ 

!SVCA 37 

MOV R3,3R4 * 

36514/ 

Trsvc 

MOV 130(R0),R3* 

3660/ 

t 

HALT 

JMP 3#24140(ret] 

1 „ 

2414Q/ 

999999 

MOV 42(R0),R1* 

241.447 

999999 

SVCA 45* 

24146/ 

999999 

BIC #4,16(R3)* 

2415V 

999999 

SVCA 45* 

"24136/ 

999999 

SVCA 37* 

241607 

999999 

10* 

241627 

i 999999 

BIS #4,16(SP)* 

24170/ 

i 999999 

LEA PC,3#3664(ret) 


"C. 

C Continued...] 
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^SAVE NEWSYS.MON (ED 
‘SAVE NEWSYS.MON 
‘.DEL 1 *(Rgfj 
’NEWSYS.MON 

7M0N6EN (ED 

Input monitor name; NEWSYS.MON (beT) 

New disk driver name: HWK500.DVR(ED 

jNew monitor name: NEWSYS.MON 1 »et) 

.. . . ■ 1 ■ .- 

TSAVE NEWSYS.MON (ED 

■ERASE NEWSYS.MON, _ SAVE NEWSYS.MON 

• DEL: * (ret | 
iNEWSYS.MON 

^MONTST NEWSYS.MON,SYSTEM.INI(ED 

NOTE: When MONGEN asks for the new disk driver name, give it the name of the 
driver used by your System Device (e.g., SMD410.DVR, HWK500.DVR, etc.’). 

Then !u$e MONTST to test the new monitor. If the system does not boot with 
NEWSYS.MON, reset the system (which will use the old SYSTEM.MON) and ,use DDT 
to verify that the patch was entered correctly. If the system boots 
properly,' rename NEWSYS to SYSTEM.MON so that your system can boot fr?om the 
new monitor on a hardware reset: 

^renIame SYSTEM=NEWSYS.MON(ED 

iNEWSYS.MON to SYSTEM.MON 


Patch #2 X4.5) Monitor Version Number Update 

After you have installed the patch above, enter the following patch to 
update'thie monitor version number to 4.5(2). 

Whenever ;you use the SYSTAT or SYSTEM command, you see a line showing your 
current !monitor version. The following patch changes this line to show 
4.5(2), indicating that you have implemented the patches in this issue of 
the ' Software Notes . This patch to the monitor does not affect the 
operation of the monitor; it just gives you a quick way to see if all 
patches have been implemented. 

: i i ■ 

IMPORTANT NOTE: This patch assumes that you have previously entered the AMOS 
4.5 (patches given in the June and July issues of the Software Notes . 
(That is,' this patch assumes that your monitor is currently version 4.5(1).) 
If the previous 4.5(1) patch was not made to your monitor, this patch will 
not 6ff,eQt the monitor version number. 
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^Et OCTAL CUD 
O.OG SYS:GUI) 

Logged into SYS: 

J)DT sVSTEM. MON fieri 

PROGRAM BASE IS xxxxx 
PROGRAM SIZE IS xxxxx 

14/ ' SUB -(R4),Q(R1) 24462^ 

16 ! 221 o (sED 

*c : ' ; 

^SAVE’ SYSTEM.MON fieri 

ERASE SYSTEM.MON, SAVE SYSTEM.MON 

J)EL SYSTEM. MON (Set) 

SYSTEM.MON 
-— 

• 

After ehtering the patch, you can verify its effect by rebooting tHe system 
and using the SYSTEM command or the SYSTAT command; either will display the 
new monitor version. For example, if you reboot and issue the SYSTEM 
command, you see: 

C I 

^SYSTEM fiiTl 

the following programs are allocated in system memory: 
l STD DVR 

i ' AMS DVR 

total resident monitor size is 15466 bytes 
Monitor version is 4.5(2) 
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SYSTEM. (Version 4.5A) 

If yourjmonitor is version 4.5A, make the following three patch'es* in the 
order given: 


Patch' #1 (4.5A) - Bootstrap Loaders on an MPC System 

PRILOb, MWKLOD, SMDLOD, and MONTST do not work correctly on some systems 
that use the AM-700 Memory Partition Controller. The following patch to the 
monitor resolves this problem: 


.LOG SYS: (ret) 

Logged into SYS: 

^COPY NEUSYS=SYSTEM.MONfREr) 
SYSTEM.MON to NEWSYS.MON 


Total of 1 file transferred 
J)DT NEWSYS.MON (ret) 

PROGRAM BASE IS XXXXXX 
PROGRAM SIZE IS 45006 
44110/ CLRB a#17746U 

45006/ ?????? 

45014/ ?????? 

4502(2/ ?????? 

4503b/ ?????? 

45034/ ?????? 

i ~ "— • - 


JMP a#45006(RET) 

MOV #105537, a#0V 
MOV #177460, a#2* 
MOV #37, a#4^ 

CALL PC, a#o^ 

JMP a#44114(213 


“C 


^SAVE NEWSYSfRiT) 
, SAVE NEWSYS 


_J)EL * (ret) 

) ~NEW$YS.M0N 

• MONTST NEWSYS. MON. SYSTEM. INI (SIT) 

-j £ * - 


If the system boots correctly, you may now rename NEWSYS.MON to SYSTEM.MON 
so that the system will automatically boot with it. (First, to be safe, you 
might warjt to rename SYSTEM.MON to another name— for example, SYSTEM.SAV.) 

I 

^RENAME .SAV=SYSTEM.MON fiiT) 

SYStEM.MON to SYSTEM.SAV 

^RENAME SYSTEM=NEWSYS. MON fieri 

NEWSYS.MON to SYSTEM.MON 
- T — - . —-- -. - . . 

NOTE: y6u do not need to use MONGEN to generate a new monitor after making 

this patch. 


Patch #2| (4.5A) - WAKE Monitor Call 

This patch to the 4.5A SYSTEM.MON fixes a problem with the WAKE monitor 
call. ( {The symptom of the problem is that the SLEEP monitor ^call returns an 
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improper return code if a job is awakened from another memory bank. 

k 

Note that ’/pur MUST use MONGEN to generate a new monitor after making- this 
patch; thip < is because the patch extends into a portion of the current 
driver ar^av and you must use MONGEN to re-embed the driver. 

NOTE: Thejpnderlined question marks below indicate that the contents of that 
memory location may be anything. 

j^SET OCTALfRETl 
J.0G SYS: (Bin 
Logged into SYS: 

.COPY NEWSYS=SYSTEM.MONfRlrt 
SYSTEM.MON to NEWSYS.MON 


Total,- of 1 file transferred 


.DDT NEWSYS.MON (ret) 

PROGRAM,BASE IS XXXXXX 
PROGRAM SIZE IS 45040 

210/] SUB -(R2),0(R4) 

24364 (EED 

\ 

20452/ ;SUB -(R2),0(R4) 

24364 (EH) 

3640i BR 3644 

! i 

3644/ MOV 3R4,R3 

BR 3652(EID 

CMP R4,#162* 

3650/ CMP 6(R3),R0 

BEQ 3706 4' 

3652/ BPT 

MOV 3R4,R34' 

3654/ BNE 3642 

CMP 2(R3),#35744-- 

3662/ MOV 130(R0),R3 

BNE 36424- 

3664/ SVCA 30 

CMP 6(R3),R04- 

3670/ HALT 

BNE 36424 

3672/ ■ RSTS 

SVCA 334 

3674/ • SVCA 37 

MOV R3,3R44 

3676/ > RSVC 

MOV 130(R0),R34 

3702/ HALT 

- r- f - 

JMP a#24264(EH) 

24264/ ?????? 

MOV 42(RO) ,R14- 

70)1 999999 

SVCA 454 

21 * 272 / 999999 

BIC #4,16(R3)4 

24300/ ?????? 

SVCA 454 

24302/, ?????? 

SVCA 374 

24304/ ?????? 

104 

24306/' ?????? 

BIS #4,16(SP)V 

74^1^/ 999999 

LEA PC .a#3706[R£T| 
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i ' l 

I.SAVE NEWSYS.MON fijir) 

SAVE NEWSYS.MON 
*PEL * tBETl 
NEWSYS.MON 

TM0NGEN(rIt> 

Iftput monitor name: NEWS YS. MON IreTI 
New.disk driver name: HWK500 .DVR(rID 
New monitor name: NEWSYS.MONfRiTI 

• { 

TjSAVE NEWSYS.MON (ret) 

| ENASE NEWSYS.MON, _ SAVE NEWSYS.MON 

_jOEL * (ret'i 
NEWSYS.MON * 

JWJJTST NEWSYS.MON.SYSTEM.INI (ret) 

v 

NOTE:'When MONGEN asks for the new disk driver name/ give it the name of the 
driyer used by your System Device (e.g./ SMD410.DVR/ HWK500.DVR/ etc.). 

Then use MONTST to test the new monitor. If the system does not boot with 
NEWSYS.MON, reset the system (which will use the old SYSTEM.MON) and use DDT 
to verijfy that the patch was entered correctly. If the system boots 
properly, rename NEWSYS to SYSTEM.MON so that your system can boot from the 
new monijtor on a hardware reset: 

^RElMME SYSTEM=NEWSYS.MON(ret) 

NEWSYS.MON to SYSTEM.MON 


i 

Patch ,#3 (4.5A) Monitor Version Number Update 


After*yop have installed the two patches above, enter the following patch to 
update the monitor version number to 4.5A(1). 

Whene\ierJ you use the SYSTAT or SYSTEM command, you see a line showing your 
current monitor version. The following patch changes this line to show 
4.5A<1),- indicating that you have implemented the patches in this issue of 
the Software Notes . This patch to the monitor does not affect the 
operation of the monitor; it just gives you a quick way to see if all 
patches have been implemented. 
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^SET OCTAL(siD 
J.OG: sfsi(slD 
Logged|ipto SYS: 
JJDT; SYStEM.MON (bet) 


PROGRAM BASE IS xxxxx 
PROGRAM SIZE IS xxxxx 
14/ 0 30450 4 



“C ) i 

^S AVE >' SYSTEM .MON (ret) 

ERASE' SYSTEM.MON, _ SAVE SYSTEM.MON 

J>EL SYSTEM.MON (ret) 

sysYem.mon 


£ 

After entering the patch, you can verify its effect by rebooting the system 
and using the SYSTEM command or the SYSTAT command; either will display the 
new monitor version. For example, if you reboot and issue the SYSTEM 
command, you ?see: 

: | 

^SYSTEM (ret) 

The following programs are allocated in system memory: 

7 STD DVR 

' • AMS DVR 

Tot^al resident monitor size is 15466 bytes 
Monitor version is 4.5a(1) 


